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OISWH/ALLOCAIOR 


INIRQQUCTION 


The DISK/ALLOCATOR program is used te create Instatilaticn 


Allocated Cisk CIAC) files. Absolutely alloceted disk files cre 


useful for: 


1. Recovering files after COLDSTARTing 6 system disk or 
| purging a user cisk. | 


ae Allocating file areas to specific EU's or packs cf 
systems disk. | 


3.  fecavering specific areas of files that have been 
physicatly or egically corrupted. 


however» these capabilities are bought at the cost of a mechanisa 
which subverts aii reascnable requiremerts of a data~secure 
systen. Any instatlaticn supporting IAD files should realize 


that their syste say no icncer be secure. 


RELATED EUELICATIONS 


Name | Number 


Software Operaticrat Guid | 10€8731 
WCPIZ | PeSe 2212 5462 


| | 7 2-1 
EURROUGHS CORPORATION | | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP — BLBCO/B17C0 DISK/ALLOCATCR 
SANTA BARBARA PLANT PeSe 2219 0425 


QPERATING INSTRUCTIONS 


CISKZALLOCATOR expects input specifications to be in the format 
cescribed in this section. Input is from the SPQ» unless Prograr 
Switch Zerc is set to one (1). Then input is from a card deck 
labeiled “CAROS". | : . 


~WEYHORD SYATAX 


DISK/ALLOCATOR requires ali specifications to te in the form: 


<keyword> = <vatlue> 


Wore than one sgecificaticn can be entered per accept message» 
with individual specificaticns separated ty either tlanks ora 
CORBA Users may enter as many ACCEPT messages as are needed to 
input atti the file specifications. However » indivicacual 
ksyword-value pairs cannct be separated between different ACCEFT 
gessages nor can they be broken across record toundaries if the 
input is frog cards. | 


The equatis sign (=) must be included.— Numbers can be either 
hexadecimal or ceciaat digits» tut hex digits must be enctasec 
with a-signse | 7 
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KEYWORD LISI 


Users must specify all non-default eneesecoriaties of each IAL 
file. The keywords» along with their default values» are Listea 


beloau. If no aefauit is givene the keyxord is required. Aid 


keywords with cefauits tisted are optional. 


KEYWORD «DESCRIPTION == DEFAULT. 


TITle Allowable file name None 
RECSIZE Characters per record 7 180 
BLOCKSIZE Records per block | i 
AREASIZE Blocks per area | 100 
AREAS Nusber cf areas ? 25 
LASTRECCKRC Eof pointer | 0 
FAMILYINCEX Disk unit CEL) 0 
AREANBR area nuaber | None 


AFEAACDFESS thysicai sector address None 


SPECIFICATION PROCESS 


More than ocne file can be attocated fer execution. File 
specifications are initiated by the keyword “TITLE%» anc ar 
individual file is considered cogplete when one of the following 
conditions is true: 


1) Another "TITLE" is enccuntered in the input streaa. 

2) The user enters a blank AX message. 

3) End-of-file is reached on the cara deck. 
The first keyword. eoeea tied 0% each file aust be STITLES» inc 
TITLE must be an ailcwable file names egt 

TITLE = MYDISK/TEST/FILE 

Following TITLE» users must specify ali the characteristics cf 
the file that must be set before the file is opened: RECSIZE >» 
ELCCKSIZE>s AREASIZE» and AREAS. If any of these specifications 


are aomittecs the cefaults will be used. The defaults for reccre 
size and biccking are i8C/1. Areastze and number of areas wtlt 


: defauit to 100 biocks per area and 25 areas. 
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Then»e users can specify individual areas end their addresses 
through the keywords FAMILYINDEX»s AREANBR» and AREAADDRESS. 


FAMILYINDEX specifies the continuation numter of the disk family. 
This indicates the disk EL number. If FAMILYINDEX is zeros the 
areas are assigned in the system"s normal rotational order. 


FAMILYINDEX is opticnal» bat once it is set it is used for all cf 


that file*s areas» until it is reset. 


Users must specify an area number for each area to be  altocated. 
AREANBR can be between 1°1C5» but cannot exceed the total nuecer 
cf areas declared fcr the file. AREAADDRESS gives the actual 
physicat cisk adecress requested for the file. The specificec 
areas wilt be attocatec if the requested disk address is 
avaidabie. , | 


LASTRECOROD specifies the setting of the end-of-file pointer. 
Extreme caution shcuid be used to insure that LASTRECORE is 
actuatily pcinting tc somewhere within the file*s altocated areas. 
LASTRECORD can te specified anywhere after the TITLE keyword. 
However» onty the last value requested wilt be used. The default 


setting ts zero. 


FILE ALLOCATION 


CISK/ALLOCATOR will cpen the IAD file GUTPLT NEWs and will then 


atteapt to aliccate the areas. If it succeeds in aitocating the 
areas» it wilt clcse the file» tock it irto the disk directcry, 
and display the sessage 


<titte> ALLOCATED 


If it faiis to aliccate an area» or if no areas are requestecs 
the prograr wilt purge the fite. | Once the fite has teen 
successfully adiccated» DISK/ALLOCATOR widll attempt to set the 
dast record. If it fails» it wilt aisplay a warning messager tut 
the file will resair intact. 


Gefore the MCP cpens the IAD file» it must use some disk space 
for the file header. This requires from one to three contiguous 
sectorss daepencine en the number cf areas ceciered for the file: 


i-25 areas i sector 
26°65 areas ¢ sectors 
2 sectors 


66-105 areas 
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The file header wsitl be ocated at the lowest available cisk 


addresse 


SAMPLE EXECUTES 


A sample execution soulta invotve the fcellowing messages anc 
responses: | | 


‘Gperator: EX DISK/ALLOCATOR 


Prograg: ENTER SPECS. 


Qperator: <jeb nuaber> AX TITLE = PERM/DATA» AREAS = 10 


Program: ENTER SPECS 


Operator: <jcb number>aX RECSIZE = 90 BLOCKSIZE=2> AREASIZE 


Prograr: ENTER SPECS 


Cperatecr: <jecb nusber>AXLASTRECORO = 450 


Pragras: ENTER SPECS 


Operator: <job nugber>AX AREANBR = 1» AREAADDRESS 


= 2684 
Prograg: ENTER SPECS 
Qperatcr: <job number>AX AREANBR = 5» AREAADDRESS = 22744 
Prograge: ENTER SPECS 
Gperator: <jcob number>AX Cfor termination) 
or 
Crerator: <job  number>AX TITLE = ANCTHER/FILE (for 


ccontiruation. 
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If input to OISK/ALLOCATOR is from cards» Program Switch Zero 
must be set to ane in the execute statement. A sample card ceck 
is given beicw. 


[cee canmecwencwmeneanacancces an aa mm 
/ -2END j 
Jere ec err wewec ase aest a swe ete saw awanaaawenee 
/ AREANBR = 5S» AREAADRESS = @274a { 
Jeet emamwanananansaaaaaaenwe mann nana seo wana aanea a 
/ AREANBR = 1» AREAADDRESS = 2682 ' 
Jaereanerawanwwecaweeaeannecaanea i ann annaannaa 
/ LASTRECORD = 450 | | 4 


f RECSIZE = 90» BLOCKSIZE = 2 AREASIZE = 596 | 


feces ceca ec ean nse wta sacs ena acece = Ee me oe ae ee meh we ee ee ee 
/ TITLE = PERM/DATA» AREAS = 1C 
—/ 2DATA CARCS | ' 
4 2EX DISK/ALLGCATOR SwC=1 | | ; 


Figure 2ei Sarpie Card Deck 
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ERROR MESSAGES 


Errors are detectec either by the MCP or by the program. Once an 


error has been detected» the program wilt stop handting the 
current file» and wvitd scan the ingput stream until it finas a 
"TITLE™ keyuord. It will continue in the normat manner from that 
point. | 


PROGRAM ERROR MESSAGES 


1. =INVALIC <ke yword>--<vaiue> 


<value> is not a valid setting fer this <keyword> 


2. INVALID TCKEN--<string> 


The <string> is not a valid keyword. 


3. EQUAL SIGN EXPECTED 


A keyword was not followed by an *=" 


4e VALUE EXPECTED AFTER = 


The value was missing from a keysword-value pair. 


5 UNEXPECTEC TOKEN“~-<keyword>--TITLE EXPECTEC 
The program xas expecting the keyword “TITLE. This 


usuaifly appears after an input error when the prograa 
is scanrirg for a TITLE so it can resume processing. 


6. CANNOT SET FAMILYINDEX TO <integer> 
The programs could not set the family index to the 
requestec vaiue. | | 
7. CANNOT ALLOCATE AREA@-NEED AREANBR 


The user specified an AREAADDRESS without first 
specifyirs the AREANBR. 
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8. CANNOT ALLOCATE AREA <integer> 


De 


10. 


BCE ERROR 


le 


Ze 


50 


The specified area could not te altocated. An PCF 


error sessage witt give the reason for failure. 


LASTRECORC OF <irteger> IS NOT WETHIN ASSIGNED FILE 


AREA 


The vatiue for LASTRECORD is cutside the file*s maximur 
altlocatec area. | | 


CANNOT SET LASTRECORD 10 <integer> 


The precran could net set the end-of-file pointer to 
the requested value. 


MESSAGES 


INVALIC TAD COMMUNICATE FOR NON DISK FILE CN FILE 
ATTRIBUTE REQUEST FOR FILE LADFILE LABELLED <title> 


The user cirected ITADFILE to a non-disk device. 


IAD REQUESTED AREA <integer> HAS ALREADY SEEN ASSIGNEC 
CN FILE ATTRIGUTE REQUEST FOR IACFILE LABELED <title> 


An area number can onty be allocated once. 


IAD REGUESTED DISK ADDRESS <integer> NOT AVAILABLE CA 
FILE ATTRIBUTE REQUEST FOR FILE IAOFILE LABELLEL 
<titte> 


The specified hex address was not available. 
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